home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / rbbs / rbtch180.zip / RBATCH.DOC < prev    next >
Text File  |  1992-08-28  |  52KB  |  1,303 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                       ------------------------------------
  22.                         RBatch - RBBS-PC Batch Uploading
  23.                                HS/Link, & BiModem
  24.                                     Interface
  25.                       ------------------------------------
  26.  
  27.  
  28.  
  29.  
  30.                                RBatch Version 1.80
  31.                                  August 29, 1992
  32.                               By: Dan Shore - SYSOP
  33.                                 THE SHORELINE BBS
  34.                                  (301-946-2771)
  35.  
  36.  
  37.  
  38.  
  39.                                  TABLE OF CONTENTS
  40.                                 -----------------
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.      A. INTRODUCTION
  49.           1.  What is RBatch ....................................  3
  50.           2.  What it does ......................................  3
  51.  
  52.      B. INTERFACING RBATCH WITH RBBS-PC
  53.           1.  The RBatch Configuration File .....................  4
  54.           2.  Line-by-line analysis of the configuration file ...  5
  55.           3.  Additional notes on the configuration file ........ 12
  56.           4.  The RBBS-PC Proto.Def Setup ....................... 13
  57.           5.  Batch Files used in Proto.Def ..................... 14
  58.           6.  The RBatch Command Line ........................... 15
  59.           7.  SysOp Designed Batch Files ........................ 15
  60.           8.  Batch File Passed Parameters ...................... 16
  61.           9.  Calling other testers from the batch files ........ 16
  62.           10. Batch File Examples ............................... 16
  63.           11. Colorized Batch Files ............................. 17
  64.           12. Alternate Batch File Names ........................ 19
  65.           13. Flexibility in RBatch File Processing ............. 19
  66.  
  67.      C. MISCELLANEOUS INFORMATION
  68.           1.  Use of Recovery with Protocols and RBatch ......... 19
  69.           2.  User Time-Outs and Dropped Carriers ............... 19
  70.           3.  RBatch Error Logging .............................. 20
  71.           4.  What Do The Included Merges Do .................... 21
  72.           5.  Why Is RBatch An External Program ................. 21
  73.           6.  Companion Program For RBatch ...................... 21
  74.           7.  Warranty And Disclaimer ........................... 22
  75.           8.  Registration ...................................... 22
  76.           9.  Acknowledgments ................................... 23
  77.           10. Support ........................................... 24
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.                                        -2-
  93.  
  94. A.                             INTRODUCTION:
  95.  
  96.  
  97.  
  98. A-1.     What is RBatch?
  99.          ---------------
  100.  
  101. RBatch is an upload interface utility for RBBS-PC Bulletin Board Systems.
  102. RBatch enables RBBS-PC (versions 12.x-17.4) to receive and process BATCH
  103. uploads.  It is an EXTERNAL program (NO code modification is necessary)
  104. that is called by RBBS after file transfers. It reads a standard, "true"
  105. DSZ log file (XFER-?.DEF) generated by most of today's better file transfer
  106. protocols, and reports the uploaded information to RBBS's system files
  107. in ways that make the SysOp's job much easier and less time-consuming.
  108. RBatch is fossil-aware, but does NOT require a fossil to run.
  109.  
  110. RBatch also is the interface for the new and extremely popular protocol,
  111. HSLINK, by Sam Smith--and the BiModem bi-directional protocol.
  112.  
  113.  
  114. A-2.     What it does?
  115.          -------------
  116. RBatch is called after file transfers are completed, and will:
  117.  
  118.      - check each file uploaded to see if it is a DUPLICATE of
  119.         a file already on the BBS.   This is accomplished by RBatch
  120.         checking the FFS (FIDX.DEF & FIDXT.DEF) and/or the SysOp 
  121.         designated directories that are listed in the RBatch 
  122.         configuration file.
  123.  
  124.      - check uploaded file INTEGRITY with SysOp designed batch files.
  125.         Files may be scanned for viruses, unwanted uploads, files too
  126.         old, etc.  Comments and logos may be stripped or added in these
  127.         BATCH FILES.
  128.  
  129.      - ask the user for an upload CATEGORY (if security level allows),
  130.         and a DESCRIPTION of the file.  Or, optionally, process
  131.         FILE_ID.DIZ, DESC.SDI or .DOZ files AUTOMATICALLY and post 
  132.         the file descriptions in them to the FMS.  No TYPING!
  133.         (See WHATISA.DOZ for details on RBatch's new and revolutionary
  134.         .DOZ File Descriptions Process).
  135.  
  136.      - post all necessary information to the FMS directory, USERS,
  137.         & CALLERS files.
  138.  
  139.      - Award time credits for the upload based on the user's security level.
  140.  
  141.   ***********************************************************************
  142.   * NOTE:  RBatch is responsible for the logging and processing of ALL  *
  143.   *        uploaded files, while RBBS is responsible for ALL downloaded *
  144.   *        files.                                                       *
  145.   ***********************************************************************
  146.  
  147.                                        -3-
  148.  
  149. B.                      INTERFACING RBATCH WITH RBBS:
  150.  
  151.  
  152. Three things are crucial to the proper "marriage" between RBatch and
  153. RBBS-PC:
  154.  
  155.         1.  The RBatch configuration file.  (Which you must create.)
  156.         2.  The RBBS PROTO.DEF file. (Which you must modify.)
  157.         3.  The Batch Files that are in the Proto.Def.  Example are
  158.             included, just change them to match your system.
  159.  
  160. B-1.     The RBatch configuration file:
  161.          ------------------------------
  162.  
  163. Here is the layout and description of each line in the RBatch
  164. configuration file.  (Note that the configuration file CANNOT
  165. have comments like those in the example below!):
  166.  
  167. D:\Uploads;YES                   ###   <-- 1  Path to upload directory;Pause Prompt
  168. No;C:\Rbbs\Dorinfo[NODE].Def           <-- 2  Create;Path to DORINFOx.DEF
  169. ZIP;LZH;ARJ;ZOO;EXE                    <-- 3  Archive types to check for
  170. 5,50;10,100;15,150;20,200              <-- 4  Security level,credit parameters
  171. C:\Rbbs\Master.Dir;NONE                <-- 5  FMS;2nd place to write
  172. BLANK                                  <-- 6  Path to NON-FMS dirs
  173. C:\Rbbs\Messages                       <-- 7  Path to RBBS MSG file
  174. C:\Rbbs\Users                          <-- 8  Path to RBBS USERS file
  175. C:\Rbbs\Caller[NODE]                   <-- 9  Path to RBBS CALLERS file
  176. C:\Rbbs\Dir.Cat                        <-- 10 Path to RBBS directory categories
  177. C:\Rbbs\Xfer-[NODE].Def                <-- 11 Path to DSZ transfer log
  178. SECRET NAME                            <-- 12 SYSOP'S secret name
  179. 5;C:\Rbbs\Upcat.Hlp                    <-- 13 SEC for cat.;Hlp file for upcat
  180. FMS                                    <-- 14 Using FMS or .DIR
  181. UNC                                    <-- 15 Default category code
  182. ZIP                                    <-- 16 Extension to convert to
  183. YES                                    <-- 17 Save files on timeouts/errors?
  184. NO                                     <-- 18 Using FOSSIL?
  185. 46                                     <-- 19 # characters in description line
  186. 5;NO                                   <-- 20 # lines in FMS descriptions
  187. YES;C:\Rbbs\Fidx.Def                   <-- 21 Use FIDX system?;location
  188. C:\Rbbs\Dupelist.Lst                   <-- 22 Additional DIRs to look for dupes
  189. DV                                     <-- 23 Environment running
  190. THE SHORELINE BBS                      <-- 24 BBS Name
  191. 00000000000000000000                   <-- 25 Registration # (or all 0's)
  192. YES;C:\Work;C:\Arc.Lst                 <-- 26 CHECK for DOZ?;WORK dir;archives
  193. BATCH.BAT;BATCH1.BAT;BATCH2.BAT        <-- 27 OPTIONAL PARAM naming BAT files
  194.            < ### = Denotes New Parameters for RBatch 1.80 >
  195.  
  196. This is the heart of the RBatch process.  This text file tells RBatch
  197. the name and location of all the files that it needs or uses on your
  198. system.  It sets security levels, upload credits, paths, duplication
  199. checking methods, designates batch files to call scanning programs and
  200. archive checkers, and much more.
  201.  
  202.                                        -4-
  203.  
  204. This file may be created with your favorite editor, like QEdit or QDos
  205. editor, and may be named anything you wish, or stored anywhere on the
  206. system.  All you need to do is tell RBatch the name and location of
  207. its configuration file on the RBatch command line.  THERE IS NO
  208. DEFAULT FILENAME THAT RBATCH LOOKS FOR.
  209.  
  210. B-2.    Line-by-line analysis of the RBatch configuration file:
  211.         -------------------------------------------------------
  212.  
  213. 1.  Path to Upload Directory;Pause Prompt
  214.  
  215.       - This is the full path to your Upload Directory.
  216.         (Path/Dir - NO TRAILING BACKSLASH)
  217.  
  218.       - 20 Second Pause Prompt - enter YES after semi-colon.  If you
  219.         just have your path to the Upload Directory and NO SEMI-COLON
  220.         then the feature is DISABLED.  The pause prompt stays for 20
  221.         seconds or until user hit ENTER Key.
  222.  
  223.         Pause prompt looks like this:   Press [ENTER] to continue: . . .
  224.         Dots will go back and forth until user hits enter or 20 Secs. passes
  225.         ### (This is a new feature for 1.80)
  226.  
  227. 2.  Shall RBatch create a DORINFOx.DEF;Path/name of the DORINFOx.DEF file:
  228.  
  229.         First parameter MUST be either YES or NO.  If you are
  230.         running RBBS-17.4, you would specify "NO." (RBBS v.17.4
  231.         is the first version to create its own DORINFOx.DEF file
  232.         for DOORING protocols) for the first parameter, and the
  233.         location of the DORINFOx.DEF file for the second parameter.
  234.         All earlier versions of RBBS prior to 17.4 specify "YES"
  235.         and RBatch will create a "working" copy of the DEF file in
  236.         this specified location.  (Note semicolon...)
  237.  
  238.         If you examine this file when RBatch creates it,
  239.         you will notice that it does not have the "normal"
  240. ====    DORINFO information in it.  Do not be concerned, I only   ====
  241.         write the information I need to run RBatch.
  242.  
  243.             NO  = RBatch DOES NOT create ; path to RBBS's (17.4) own file
  244.             YES = RBatch DOES create ; where you want us to put it
  245.  
  246. 3.  Extensions to check for duplicates -- or NONE:
  247.  
  248.         This parameter allows the SysOp to specify which
  249.         extensions to check when RBatch checks for duplicates
  250.         of uploaded files.  If SysOp only wants the uploaded file
  251.         checked just input the word NONE here instead.
  252.  
  253.             ARC;ZIP;LZH;ZOO
  254.             NOTE: ALL THE EXTENSIONS MUST BE SEPARATED BY A SEMI-COLON!!!
  255.  
  256.  
  257.                                        -5-
  258.  
  259. 4.  Security Level,Time CREDIT percentage given for UPLOADS (###):
  260.  
  261.  
  262.         Time credits may now be assigned by security level(s).
  263.         The format for the Time Credit line in the configuration file is:
  264.  
  265.         SECURITY LEVEL1,PERCENTAGE1;SECURITY LEVEL2,PERCENTAGE2
  266.  
  267.         Here is an example:    5,125;10,150;15,175;25,200
  268.  
  269.             Users with security levels LESS THAN OR EQUAL TO 5 
  270.               would get 125%,
  271.             Users with security levels between 6 and 10 would get 150%,
  272.             Users with security levels between 11 and 15 would get 175%,
  273.             Users with security levels between 16 and 25 would get 200%.
  274.         ~(Note the way commas and semicolons are used on this line.)
  275.  
  276.  
  277.         You must have the HIGHEST value security level at the minimum
  278.         if just using one time credit percentage.  In other words, if
  279.         the highest security level of a user on your BBS is 100, and you
  280.         want ALL your users to have 100% time credits, then your
  281.         configuration line would be:
  282.  
  283.                        100,100
  284.  
  285.         Remember that RBatch checks to see if the user's security
  286.         level is LESS THAN OR EQUAL TO the security level(s) on this
  287.         line and then uses the associated percentage.
  288.  
  289.         Note also, that if you use multiple security levels, this line
  290.         should read (left to right) from lowest security level to the
  291.         highest, just like the examples.
  292.  
  293.         Currently you may define up to twenty security levels.
  294.  
  295.         The amount of time credit received (based on the percentage) is
  296.         calculated as shown in these examples:
  297.  
  298.             Ex. # 1  -  File upload time = 5:00 Minutes
  299.                         Time Credit%    = 150% (7:30 Minutes)
  300.                         5:00 + 7:30      = 12:30 of Time Credits
  301.             Ex. # 2  -  File Upload Time = 5:00 Minutes
  302.                         Time Credit%     = 50% (2:30 Minutes)
  303.                         5:00 + 2:30      = 7:30 of Time Credits
  304.             Ex. # 3  -  File Upload Time = 5:00 Minutes
  305.                         Time Credit%     = 0%
  306.                         5:00 + 0         = 5:00 of Time Credits
  307.  
  308.         The User always gets the time back it took to upload the file,
  309.         plus the percentage that you assign in the configuration file.
  310.  
  311.  
  312.                                        -6-
  313.  
  314. 5.  Path/Name of primary FMS DIR file;Path/Name of secondary FMS DIR file:
  315.  
  316.         This is the text directory where the uploaded filenames and their
  317.         descriptions are WRITTEN.  If you wish to post this information
  318.         to more than one file, list the path/name of the second file AFTER
  319.         the Semi-Colon.  If you do not wish to post to more than one file,
  320.         then you must enter "NONE" as the second parameter.
  321.  
  322. 6.  Path to the .DIRs - Enter the word "BLANK" if using FMS:
  323.  
  324.         This is the path to where your .DIR's are.  An example of
  325.         this is:
  326.                        C:\FILES\
  327.  
  328.  
  329. 7.  Path/Name to MESSAGES File:
  330.  
  331. 8.  Path/Name to USERS File:
  332.  
  333. 9.  Path/Name to CALLERS File:
  334.  
  335. 10. Path/Name to DIR.CAT File:
  336.  
  337.  
  338. 11. Path/Name to XFER-?.DEF File:
  339.  
  340.         Protocols ALWAYS write the Xfer-?.Def file in the CURRENT directory
  341.         when the protocol is invoked.  Make sure that you have your
  342.         SET DSZLOG=XFER-?.DEF (? = Node #) in your AUTOEXEC.BAT or your
  343.         DESQVIEW startup window batch file.  Do not use a path in
  344.         your SET DSZLOG statement.
  345.  
  346.         For example, if you are in the RBBS directory when you execute
  347.         DSZ, the XFER-?.DEF file will reside in the  RBBS Directory.
  348.         If you change to your upload directory when you invoke DSZ,
  349.         the XFER-?.DEF file will reside in your upload directory.
  350.         Note that RBatch will DELETE the XFER-?.DEF file, when there
  351.         are just uploads.
  352.  
  353.         If you are doing bidirectional transfers, the XFER will have
  354.         to be located in the current directory as the user when doing
  355.         a transfer (the Main RBBS directory or the Node Directory).
  356.         RBatch will not delete the XFER due to RBBS needing to "see"
  357.         the XFER file to report a successful transfer.
  358.  
  359. 12. SysOp's secret name (ALL CAPS):
  360.  
  361.         Enter "BLANK" if you do not wish the USERS file to be updated
  362.         with file count information for SysOp file transfers.
  363.  
  364.  
  365.  
  366.  
  367.                                        -7-
  368.  
  369. 13. Min Security Level to Categorize;Path/Name of UPCAT.HLP File:
  370.  
  371.         The First Parameter is the MINIMUM security level a user must have
  372.         in order to categorize a file that he/she uploaded.  If their level
  373.         is LOWER than this value, the uploaded file will have the default
  374.         category code for FMS (line #15), and in the .DIR system, will be
  375.         posted to the file listed on line #5 in this configuration file.
  376.         The Second Parameter is the path/filename of the UPCAT.HLP file.
  377.  
  378.             < A useful feature for SYSOPS is that you do not have
  379.               to use the SAME UPCAT.HLP file you specify in RBBS's
  380.               CONFIG parameter #!  The file you specify here may
  381.               display entirely different categories, or you may
  382.               create a special one for local/SYSOP only uploads! >
  383.  
  384.  
  385. ###     ----------------> New in RBatch 1.75 <----------------      ###
  386.  
  387.         RBatch now supports colorized UPCAT.HLP files for users that
  388.         have color chosen as their graphics type.  The program will look
  389.  
  390.  
  391.         for the following:
  392.  
  393.         Non-Color Graphics Choice         Color Graphics Choice
  394.         -------------------------         ---------------------
  395.  
  396.             UPCAT.HLP                         UPCATC.HLP
  397.  
  398.     You will note that the program looks for the filename with a "C"
  399.     appended to the filename.  If the "C" file does not exist then
  400.     the non-color file is used.  Also, remember that you can call
  401.     RBatch's UPCAT.HLP file whatever you wish, as long as it is specified
  402.     in the configuration file.
  403.  
  404. 14. Are you using FMS or .DIR?
  405.  
  406.             Enter:  FMS or DIR
  407.  
  408. 15. Default Category or Path/Name of SysOp-only uploads file (.DIR):
  409.  
  410.     This is the category given to uploads:
  411.             1. that are saved by the SysOp after a user times out
  412.                (falls asleep, too busy getting a beer, etc.) during or
  413.                after the upload WITHOUT entering the category.
  414.             2. if a user drops carrier during the upload process.
  415.             3. where the user does not have a high enough security level
  416.                to categorize uploads.
  417.  
  418.     If the SysOp is using the .DIR file system, then this entry will be
  419.     the path/name of the file that the SysOp wants the personal (/) uploads
  420.     posted to.  This file is only for the .DIR file system and not the FMS.
  421.  
  422.                                        -8-
  423.  
  424. 16. Compression type all files are converted to:
  425.  
  426.     Enter "NONE" if you perform no conversions in your Batch File
  427.  
  428.     If you have batch files (PHASE?.BAT, CARCZIP.BAT, etc.) which convert
  429.     all uploaded files to a common format, enter the extension converted
  430.     TO here, otherwise, enter "NONE."
  431.  
  432. 17. Save files on User Timed Out or Dropped Carrier Uploads?
  433.  
  434.             Enter:  YES or NO
  435.  
  436. ==== See section below on "User Time-Outs and Dropped Carriers"    ====
  437.  
  438. 18. Use Fossil Driver?
  439.  
  440.             Enter:  YES or NO
  441.  
  442.         RBatch has support for the fossil drivers X00 or BNU.
  443.         Enter either "YES" or "NO" on this line in the configuration file.
  444.         (We also support 16550AFN UARTS.)
  445.  
  446. ==== If you run with a special type of COM Port setup (non-standard ====
  447.         IRQ's, etc.) you will be required to utilize a FOSSIL driver,
  448.         or RBatch will not function properly!
  449.  
  450. 19. Size of first FMS/.DIR File Description Line:
  451.  
  452.             Enter:  a number from 40 to 46
  453.  
  454. 20. Number of Lines for Extended Descriptions;Use BAMA support?
  455.  
  456.             Enter:  # of lines;YES or NO
  457.  
  458.      Place the value of the maximum number of lines you will allow in
  459.      your FMS/.DIR's for extended FMS descriptions as the FIRST parameter
  460.      on this line.  As a second parameter, enter either "YES" or "NO"
  461.      --"YES if you use the BAMA WHO mod for posting the name of the
  462.      uploader to the FMS, "NO" to disable this feature.
  463. ==== (For NO extended descriptions, enter "0" as the FIRST parameter.) ====
  464.  
  465. 21. Use FFS System;Path/Name of Fidx.Def file?
  466.  
  467.             Enter:   YES or NO  for using FFS System
  468.  
  469.     It is assumed that if the SysOp uses the TAB file of the FFS system,
  470.     that the filename is the same as the FIDX.DEF file, except that it
  471.     has a "T" in it, (i.e. FIDX.DEF, FIDXT.DEF) and that that TAB file
  472.     is located in the same directory (second parameter of this line is
  473.     the Path/Name) as its FIDX.DEF file.
  474.  
  475.  
  476.  
  477.                                        -9-
  478.  
  479. 22. Path/Name of file listing Directories to check for duplicate Uploads:
  480.  
  481.     This is a FILE that contains PATHS to file directories
  482.     to be checked for duplicate files in ADDITION to the ones that the
  483.     FFS already indexes. Here is an example of a listing:
  484.   
  485.     Do not enter each of these paths in the configuration file!!
  486.     The filename you specify on the configuration line contains
  487.     these paths.
  488.  
  489.                     c:\temp\
  490.                     c:\testing\
  491.                     d:\other\
  492.  
  493. ==== (One directory per line, and each line must end with a backslash!) ====
  494.  
  495.     If you specify "NO" for using a FFS system in line #22, then this
  496.     list of directories is what is used by RBatch to check for duplicate
  497.     uploads.
  498.  
  499. 23. Environment Running under (choose one):
  500.  
  501.             Enter:  DOS - Running RBBS-PC\RBatch in DOS
  502.                     DV  - Running RBBS-PC\RBatch in DV
  503.                     NET - Running RBBS-PC\Rbatch in a Network Environment
  504.                             that REQUIRES running DOS's SHARE.EXE
  505.  
  506. 24. BBS Name to appear on Registered Versions:
  507.  
  508.             Enter:  50 characters Maximum
  509.  
  510. 25. Registration Number:
  511.  
  512.             Enter:  20 Alpha-Numeric Registration Code
  513.  
  514.             (Input all "0"s if unregistered)
  515.  
  516. 26. Process .DIZ/.SDI/.DOZ files?;Work Directory;File with archive commands:
  517.                  1                      2                 3
  518.  
  519.             Enter:  1. YES or NO - This tells RBatch to process FILE_ID.DIZ,
  520.                                    DESC.SDI, or .DOZ files.
  521.                     2. Path to the work directory we will use to decompress
  522.                        the DIZ, DOZ*, or SDI file into.  NOTE: This directory
  523.                        must actually exist in order to process these files!
  524.                        RBatch creates, then deletes, NODE# directories under
  525.                        this specified directory.
  526.                     3. The THIRD parameter is the filename that contains
  527.                        a list of archive extensions and their associated
  528.                        command lines for DEcompressing (unZIPping, unARCing,
  529.                        etc.) for the decompressors that you wish to support.
  530.  
  531.  
  532.                                       -10-
  533.  
  534.            Ex.:     ARC.LST (or whatever name you choose) is a text file
  535.                     like this:
  536.  
  537.                      ARJ;C:\RBBS\ARJ E
  538.                      ZIP;C:\PKZIP\PKUNZIP -O
  539.                         ^          ^
  540.                         1          2
  541.  
  542.            The FIRST part is the extension to process
  543.            The SECOND parameter is the path/command line
  544.            to use for that particular extension.
  545.  
  546. ==== NOTE: If a file is uploaded and its extension does not match an
  547.            entry in this file, the upload will not be checked for an
  548.            embedded description file (FILE_ID.DIZ or DESC.SDI).
  549.  
  550. *    For more information on .DOZ files, see the
  551.      WHATISA.DOZ file included in this archive.
  552.  
  553. 27. ###     ----------------> New in RBatch 1.75 <----------------      ###
  554.  
  555.      SysOps may now specify the NAME of the batch files that RBatch calls
  556.      for upload checking by adding another line (#27) at the BOTTOM of
  557.      the configuration file.  If NO ADDITIONAL LINE IS ENTERED, the program
  558.      defaults to the PHASE?.BAT files.  This new parameter allows you to
  559.      have separate BAT files for each NODE, for example, or one set of
  560.      BAT files to process files locally, and another for actual uploads.
  561.      Very useful if processing large numbers of files at a time, and you
  562.      want to use different process criteria for local uploads, or "real"
  563.      ones.  REMEMBER, THAT IF LINE 27 IS MISSING, THE PHASE?.BAT's are
  564.      used.
  565.  
  566. ***> One important point to remember is that RBatch looks for the batch
  567.      file in the SAME DIRECTORY as the Configuration File.
  568.  
  569.              Here are some examples of LINE #27:
  570.              -----------------------------------
  571.  
  572.      YES;C:\RBBS\WORK;C:\RBBS\ARC.LST - Currently the last line in config.
  573.      LOCAL.BAT;LOCAL1.BAT;LOCAL2.BAT  - New line is entered with the names of
  574.                                         the batch files to use.
  575.  
  576.      In this example LOCAL.BAT is called first, LOCAL1.BAT is called next,
  577.      and LOCAL2.BAT is called last.
  578.  
  579.              Here is another example:
  580.              ------------------------
  581.      YES;C:\RBBS\WORK;C:\RBBS\ARC.LST - Currently the last line in config.
  582.      LOCAL.BAT;LOCAL1.BAT             - New line is entered with the names of
  583.                                         the batch files to use.
  584.  
  585.      In this example LOCAL.BAT is called first, then LOCAL1.BAT, then
  586.      PHASE3.BAT is called last.
  587.                                       -11-
  588.  
  589.             And yet another:
  590.             ---------------
  591.      YES;C:\RBBS\WORK;C:\RBBS\ARC.LST - Currently the last line in config.
  592.      LOCAL.BAT                        - New line is entered with the name of
  593.                                         the batch file to use.
  594.  
  595.      In this example LOCAL.BAT is called first, then PHASE2.BAT is called next,
  596.      then PHASE3.BAT is called last.
  597.  
  598.  
  599.             Duh!:
  600.             -----
  601.      YES;C:\RBBS\WORK;C:\RBBS\ARC.LST - Currently the last line in config.
  602.                                       - No additional line is entered in
  603.                                         this configuration file example.
  604.                                         NOT EVEN A BLANK LINE!!!!
  605.  
  606.      In this example PHASE1.BAT is called first, then PHASE2.BAT is called
  607.      next, then PHASE3.BAT is called last.
  608.  
  609.         Note from the examples, that you may specify from one to
  610.         three new batch files for RBatch to use.  When using more
  611.         than one batch filename you MUST separate each name with a
  612.         SEMI-COLON!
  613.  
  614.         RBatch will only execute the Batch Files THAT IS CAN FIND.
  615.  
  616.  
  617. B-3.    Additional notes for the RBatch Configuration file:
  618.         --------------------------------------------------
  619.      As of v.1.70, the variable [NODE] may be placed into the
  620.      configuration file anywhere you use a path/filename option.
  621.      When [NODE] is found, RBatch will substitute the node number
  622.      from the RBatch Command line in place of [NODE].  This new
  623.      feature should allow the SysOp, if they wish, to be able to
  624.      use ONE configuration file for all their nodes on the Main
  625.      board and one for each Sub-Board.
  626.  
  627.             Here is an example usage:
  628.             -------------------------
  629.           .
  630.           NO;c:\rbbs\node[node]\dorinfo[NODE].def
  631.           .
  632.           .
  633.           c:\rbbs\node[node]\callers[NODE]
  634.           .
  635.           .
  636.           c:\rbbs\xfer\xfer-[NODE].def
  637.           .
  638.           .
  639.                 (NOTE:  [NODE] is not case sensitive)
  640.  
  641.  
  642.                                       -12-
  643.  
  644. ==== Once again I must stress that all the NAMES used in the above
  645.      configuration example are optional and SYSOP-configurable.
  646.      The only names that RBatch REQUIRES be used are PHASE.BAT,
  647.      PHASE2.BAT and PHASE3.BAT, and THEN only IF you do not
  648.      specify alternate BAT file names for configuration line #27.
  649.  
  650. ==== Also, make sure that all the lines in the configuration file end with
  651.      a carriage return.  THERE SHOULD BE NO SPACES AFTER THE LAST ENTRY
  652.      ON EACH LINE.  IF YOU HAVE SPACES, YOU WILL GET ERRORS AND RBATCH
  653.      WILL NOT RUN.
  654.  
  655.  
  656.  
  657. ==== A Note about Sub-Boards:
  658.  
  659.      In your RBatch configuration file, you should point to the MAIN
  660.      MESSAGE BASE.  If your Sub-Board uses aliases the user's REAL NAME
  661.      will be in the Main Message base and when RBatch goes to find the
  662.      user name in the Users file, it will find a match.  You should still
  663.      specify the Main Message Base even if you do not use aliases, due to
  664.      RBBS reading the Main Message base first upon return from the protocol,
  665.      hence time credits have to be written here in order for users to get
  666.      credit.
  667.  
  668.  
  669. B-4.    The RBBS-PC PROTO.DEF Setup:
  670.         ----------------------------
  671.  
  672. Equally important to proper operation of RBatch is the structure
  673. of the RBBS PROTO.DEF protocol handling file.  This file designates
  674. the way RBBS loads the external protocols, and what information passes
  675. between the two (the system and the protocol) during a file transfer.
  676. Included in this archive are examples of PROTO.DEF setups.  Please
  677. refer to these files for assistance in setting up DSZ, HS/Link &
  678. BiModem.  Also, if you are not familiar with the structure of the
  679. RBBS PROTO.DEF file, we suggest you familiarize yourself with that
  680. section of the RBBS DOCuments.
  681.  
  682. Files included here are for EXAMPLE purposes only and all param-
  683. eters and criteria (security levels, paths, etc.) that are unique to
  684. your system need to be changed to match your BBS setup.
  685.  
  686. Note in the Proto.Def example, that XModem and 1K-Xmodem are shelled
  687. to and do not use RBatch.  This was done to show you that all protocols
  688. do not have to use RBatch.  If you wish all protocols to use RBatch for
  689. processing, just change the XModem entries to match the ZModem entry
  690. and make a batch file for XModem and 1K-XModem for the downloading and
  691. the uploading side of the Proto.Def.
  692.  
  693. Remember for RBBS to recognize an entry in the Proto.Def it has to be
  694. able to "find" the batch file or program.  If you have your Proto.Def
  695. in a directory called C:\RBBS\XFER and all your batch files and protocols
  696.  
  697.                                       -13-
  698.  
  699. are also there, then your entries in the Proto.Def should have paths.
  700. Here is an example:
  701.  
  702. ....."C:\RBBS\XFER\BATCHDN.BAT [PORT#] [BAUD] [PROTO] [NODE]",".....
  703.  
  704. Note that this example only shows the "download side" of the Proto.Def
  705. entry, but I hope you get the idea.
  706.  
  707.  
  708. The only major REQUIREMENT for RBatch is that it requires DOORING to
  709. the protocol.  DO NOT SHELL!!!  This is an easy modification--requiring
  710. typing one letter in each line of your PROTO.DEF file.  (Change the "S"
  711. to a "D.")
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718. B-5.    Batch Files used in PROTO.DEF:
  719.         -----------------------------
  720.  
  721. Also included in this archive are examples of the batch files that are
  722. used in our PROTO.DEF examples.
  723.  
  724. The file BATCH.ZIP contains:
  725.  
  726.      BATCHUP.BAT   BATCHUPY.BAT   BATCHUPG.BAT
  727.      BATCHDN.BAT   BATCHDNY.BAT   BATCHDNG.BAT
  728.  
  729. The file HSLNKBAT.ZIP contains the two batch files:
  730.  
  731.      HS1UP.BAT     HS1DN.BAT
  732.      (These are for use with HS/Link)
  733.  
  734. The file BIMODEM.ZIP contains the:
  735.  
  736.      - A sample PROTO.DEF setup for Bimodem/RBatch.
  737.      - Sample BAT files used in PROTO.DEF (BI1UPA.BAT & BI1DNA.BAT).
  738.      - An example of an RBatch/BiModem configuration file.
  739.  
  740. (Again, note that these are examples and are to be used only as guidelines
  741. and should be modified to match your BBS setup.)
  742.  
  743.  
  744. SPECIAL NOTE on BATCHUPx.BAT:
  745.  
  746. For uploads with the DSZ protocols, these sample batch files first
  747. change to the upload drive & directory and then invoke the DSZ protocol.
  748. I have done it this way to show how SysOps who do not have a registered
  749. version of DSZ can designate an "Upload Directory."   With a registered
  750. version of DSZ, you may specify the path on the DSZ command line.
  751.  
  752.                                       -14-
  753.  
  754. Check the DSZ documentation (sort of like suicide, huh?) for the proper
  755. command line for registered versions.
  756.  
  757.  
  758. B-6.    The RBatch COMMAND line:
  759.         -----------------------
  760.  
  761. The RBatch command line syntax is as follows:
  762.  
  763.         RBatch <Path/Config Filename> <Port #> <Proto Letter> <Node #>
  764.  
  765.                 The config filename may have a path to it and the
  766.                 other parameters can be passed from your PROTO.DEF
  767.                 command lines with:
  768.  
  769.                     <Port #>       = [PORT#]   NOTE: Use [PORT#]-not [PORT]!
  770.                     <Proto Letter> = [PROTO]
  771.                     <Node #>       = [NODE]
  772.  
  773.         If your proto.def looked like this:
  774.           "C:\RBBS\XFER\BATCHDN.BAT [PORT#] [BAUD] [PROTO] [NODE]"
  775.  
  776.         Your RBatch command line would look like this:
  777.           RBatch Rbatch.cfg %1 %3 %4
  778.  
  779.  
  780. B-7.  SysOp Designed Batch Files (Phase1.Bat, Phase2.Bat, Phase3.Bat,
  781.                                   Phase1c.Bat, Phase2c.Bat, Phase3c.Bat,
  782.                                   or whatever name(s) you specify on line
  783.                                   #27 of the configuration file):
  784.       --------------------------------------------------------------------
  785.  
  786. These are the BATCH files (called in numerical order--PHASE1.BAT,
  787. PHASE2.BAT, PHASE3.BAT) that the SysOp creates or customizes for
  788. testing each uploaded file.  The ONLY REQUIREMENT we have is that
  789. if your batch file locates an error (corrupted ZIP, virus, unacceptable
  790. date range, etc.), it MUST delete the uploaded file!
  791.  
  792. Why?  It's simple.
  793.  
  794. If, upon return from the batch file, RBatch finds the uploaded file,
  795. it assumes the file tested OK during the batch file test (remember,
  796. RBatch itself tests nothing but the EXISTENCE of the file), and IF
  797. the file is still there, RBatch proceeds to get a description and
  798. category, then posts it to the FMS/.DIR, CALLERS, and USERS files.
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.                                       -15-
  808.  
  809. B-8.    PHASE?.BAT passed parameters:
  810.         -----------------------------
  811.  
  812. In the batch file command line, we send five parameters along with
  813. the batch filename:
  814.  
  815. %1 The first is the path & name of the uploaded file.
  816. %2 The second is the extension of the file (No Period)
  817. %3 The third is the node number.
  818. %4 The fourth is the filename with no period or extension.
  819. %5 The fifth parameter is the path to the upload directory.
  820.    (No trailing backslash)
  821.  
  822.  
  823. B-9.    Calling other testers from PHASE?.BAT:
  824.         -------------------------------------
  825.  
  826. If your system is already set up with an upload tester like ZIPLAB,
  827. RBatch will work right along with it, letting ZIPLAB handle all the
  828. upload testing.  Or, you could use the old RBBS standard upload
  829. testers. For example, PHASE1.BAT might read:
  830.  
  831.           @ECHO OFF
  832.           CLS
  833.           if %2 == ZIP GOTO ZIP
  834.           if %2 == ARJ GOTO ARJ
  835.           :ZIP
  836.              tzip.bat %1 %2 %3 %4 %5
  837.           :ARJ
  838.              tarj.bat %1 %2 %3 %4 %5
  839.  
  840. As you see, RBatch lets you use your existing batch files for checking
  841. uploads from RBBS, or you can create some new ones.
  842.  
  843.  
  844.  
  845.  
  846.  
  847. B-10.   Examples of PHASE?.BAT:
  848.         ----------------------
  849.  
  850. Example--PHASE1.BAT:
  851.  
  852. @echo off
  853. cls
  854. if %2 == ARJ goto :ARJ
  855. if %2 == ZIP goto :ZIP
  856. goto :END
  857. :ZIP
  858. echo  "Checking File Integrity"  > COM1
  859. pkunzip -t %1 > NUL
  860. if errorlevel 1 goto :DEL
  861.  
  862.                                       -16-
  863.  
  864. goto :END
  865. :ARJ
  866. echo  "Checking File Integrity"  > COM1
  867. arj t %1 > NUL
  868. if errorlevel 1 goto :DEL
  869. goto :END
  870. :DEL
  871. del %1 > NUL
  872. echo          The file %4.%2 failed the Integrity          > COM1
  873. echo          Test and has been deleted from this BBS...   > COM1
  874. :END
  875. seterror 0
  876.  
  877.  
  878. B-11.   Colorized (ANSI/High Ascii) BAT files:
  879.         --------------------------------------
  880.  
  881. If the user has graphics turned on, then RBatch will call the batch
  882. files PHASE1C.BAT, PHASE2C.BAT & PHASE3C.BAT so you can use colorized or
  883. graphic batch files.  If the "C" version batch files do not exist,
  884. then the normal ones (without the "C") are used.
  885.  
  886. Example--PHASE1C.BAT:
  887.  
  888. @echo off
  889. if %2 == ARJ GOTO :ARJ
  890. if %2 == ZIP GOTO :ZIP
  891. if %2 == GIF GOTO :GIF
  892. GOTO :END
  893. :ZIP
  894. if not exist %1 GOTO :END
  895. echo @[2J                                                             > gate1
  896. echo @[1;37m                                                          > gate1
  897. echo.                                                                 > gate1
  898. echo.                                                                 > gate1
  899. echo       IMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM; > gate1
  900. echo       :            Checking ZIP Integrity of Upload            : > gate1
  901. echo       HMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM< > gate1
  902. echo.                                                                 > gate1
  903. echo.                                                                 > gate1
  904. pkunzip -t %1 > NUL
  905. if errorlevel 1 GOTO :DEL
  906. GOTO :END
  907. :ARJ
  908. if not exist %1 GOTO :END
  909. echo @[1;36m                                                          > gate1
  910. echo.                                                                 > gate1
  911. echo.                                                                 > gate1
  912. echo       IMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM; > gate1
  913. echo       :            Checking ARJ Integrity of Upload            : > gate1
  914. echo       HMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM< > gate1
  915. echo.                                                                 > gate1
  916.  
  917.                                       -17-
  918.  
  919. echo.                                                                 > gate1
  920. arj t %1 > NUL
  921. if errorlevel 1 GOTO :DEL
  922. GOTO :END
  923. :DEL
  924. del %1 > NUL
  925. :GIF
  926. echo @[2J                                                             > gate1
  927. echo @[1;33m                                                          > gate1
  928. echo.                                                                 > gate1
  929. echo.                                                                 > gate1
  930. echo.                                                                 > gate1
  931. echo.                                                                 > gate1
  932. echo.                                                                 > gate1
  933. echo.                                                                 > gate1
  934. echo.                                                                 > gate1
  935. echo       IMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM; > gate1
  936. echo       :                        ****                            : > gate1
  937. echo       :          The Policies of this BBS state that           : > gate1
  938. echo       :              GIF's are UNWANTED FILES!                 : > gate1
  939. echo       :       THE UPLOADED .GIF FILE HAS BEEN DELETED!!!!      : > gate1
  940. echo       :                        ****                            : > gate1
  941. echo       :            You agreed to these Policies when           : > gate1
  942. echo       :              you first logged onto this BBS            : > gate1
  943. echo       :                    as a New User                       : > gate1
  944. echo       HMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM< > gate1
  945. echo @[0m                                                             > gate1
  946. del %1 > NUL
  947. :END
  948. seterror 0
  949.  
  950.  
  951. This example will show to the user that the batch file is checking file
  952. integrity by echoing out the gate#.  The line "echo." is for echoing a
  953. blank line (thanks to Fred Busteed for this command).  Note that the
  954. gate# is from using GATEWAY as your replacement for DOS's CTTY command.
  955. If you decide to use GATEWAY, be sure to make the appropriate change
  956. in your RBBS configuration file.  You can also use gate%node% if you set
  957. the node in your autoexec.bat or your DV startup bat (SET NODE=1).
  958.  
  959.   ----------------------------------------------------------------
  960.   There are more examples included in the file called EXAMPLES.BAT
  961.   ----------------------------------------------------------------
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.                                       -18-
  973.  
  974. ###     ----------------> New in RBatch 1.75 <----------------      ###
  975.  
  976. B-12.   Alternate Batch filenames:
  977.         --------------------------
  978.  
  979. If you wish to use batch files with names other than PHASE?.BAT, then
  980. specify on line #27 of the configuration file, the name(s) of the other
  981. batch files to use.  You may, for example, choose a different filename
  982. to call for LOCAL uploads, or for SYSOP FMS postings. (Refer to example
  983. 27 in section B-1 for a detailed description of this feature.)
  984.  
  985.  
  986. B-13.   Flexibility in RBatch file processing:
  987.         --------------------------------------
  988.  
  989. These batch files and their parameters will help RBBS SysOps process
  990. many different types of compressed files.  Personally, I prefer the
  991. ZIP format, but in order to allow the flexibility all RBBS SysOps have
  992. learned to love, I feel that you should have the ability to accept
  993. all types of files, convert to whatever format you prefer, and still
  994. be able to check the file for the protection of your system and your
  995. users.
  996.  
  997.  
  998. C.                   MISCELLANEOUS INFORMATION:
  999.  
  1000.  
  1001. C-1.    Use of "Recovery" with Protocols & RBatch:
  1002.         ------------------------------------------
  1003.  
  1004. Most of the protocols that work with RBatch, support file recovery.
  1005. There are two things to consider with recovery, however.  One concerns
  1006. your BBS and the other concerns how RBatch treats the file.  With
  1007. recovery, you take the chance of introducing a virus into your system
  1008. unless you have proper file checking procedures.  With RBatch, file
  1009. recovery presents a different kind of problem.  If you allow recovery
  1010. on your system, and a user uploads a file, and your system already HAS
  1011. that file, the protocol will report a good upload in its XFER-?.DEF!
  1012. RBatch, being very loyal, and trusting his little buddy, XFER, will
  1013. process the file as if it were being uploaded for the first time.
  1014. This means that you will get this file posted twice in your FMS or
  1015. .DIR, but you will only have one copy of the file.  It is up to
  1016. the SysOp to decide if he/she wants recovery or not.
  1017.  
  1018. C-2.    User Time-Outs and Dropped Carriers:
  1019.         ------------------------------------
  1020.  
  1021. The program also contains a "time-out" feature that will go into
  1022. effect in no keyboard input is received within three minutes.  The
  1023. timer starts each time a user is prompted for a category code and
  1024. file description.  When a user reaches a time-out, the uploaded file
  1025. RBatch is currently working on is either saved or deleted per the
  1026.  
  1027.                                       -19-
  1028.  
  1029. configuration setup (Line #17).  Subsequent uploads that have not
  1030. been processed are also either saved or deleted as per line 17.
  1031. (NOTE:  Files saved in this manner are posted to the FMS or .DIR
  1032. with the default category code for FMS or go in the designated
  1033. upload directory for .DIR)
  1034.  
  1035.      - All files that are uploaded are logged to the CALLERS file,
  1036.        and are also posted to the FMS/.DIR if the SysOp is saving
  1037.        files (Line #17 of the configuration file).
  1038.  
  1039.      - Entries in the CALLERS file will end with a ### if a
  1040.        time-out has occured
  1041.  
  1042.      - Uploaded files processed after a timeout, are not
  1043.        credited to the user, but all downloads are.  This
  1044.        is due to RBBS handling the downloads.
  1045.  
  1046. The program also monitors carrier, and a dropped carrier is
  1047. treated the same way as a timeout (see above).
  1048.  
  1049.  
  1050. C-3.    RBatch Error Logging:
  1051.         ---------------------
  1052.  
  1053. When RBatch detects an error, it will write to its own error log. This
  1054. file which is called RBATERR.LOG, will reside in the current directory
  1055. where RBatch is executed from.  The format for this file is as follows:
  1056.  
  1057.    <Error Message> <Node #> <Date> <Time> <File>
  1058.  
  1059. Here is an example:
  1060.  
  1061.    Cannot find XFER-?.DEF 1 01-05-92 22:34:01 c:\rbbs\xfer-1.def
  1062.  
  1063. This translates into.......RBatch could not find the XFER-?.DEF file
  1064. in the location you specified in your configuration file.  This
  1065. error occurred on Node 1 on 1/5/92 at 10:34pm.
  1066.  
  1067. Also note that the error for not finding the XFER?.DEF will be posted
  1068. in the RBATERR.LOG when a user aborts an upload,  since on an aborted
  1069. upload, the XFER-?.DEF file never gets created, hence never found by
  1070. RBatch.  One way to get around this is to put in your UPLOAD batch
  1071. file that is called from the Proto.Def statements like:
  1072.  
  1073.     c:\rbbs\dsz port %1 speed %2 rz -m
  1074.     if not exist c:\uploads\xfer-1.def goto :END
  1075.     c:\rbbs\rbatch c:\rbbs\rbatch.cfg %1 %3 %4
  1076.     :END
  1077.  
  1078. With this example the batch file checks for the exitance of the
  1079. XFER-1.DEF file and if it is there, runs RBatch, otherwise it
  1080. just exits the batch file and returns to the BBS.
  1081.  
  1082.                                       -20-
  1083.  
  1084.  ###  Note also that the %# parameters and the pathnames are only
  1085.       FOR AN EXAMPLE and should be changed to match your setup.
  1086.  
  1087.  ###  DO NOT DO THIS for a Bi-Directional Protocol on the
  1088.       download side, only on the upload side!!!
  1089.  
  1090.  
  1091. C-4.    What do the included Merges do?
  1092.         -------------------------------
  1093.  
  1094. NOTE:  You do not need to use the merges to be able to run RBatch!
  1095.        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  1096.  
  1097. Included in this archive are two merges inside the filename
  1098. MRG0812.ZIP, one for RBBS-PC 17.3C & one for v.17.4.  These merges
  1099. will allow RBBS-PC to check a stacked list of filenames that a user
  1100. enters after the "Upload what file(s)" prompt.  Each filename will
  1101. then be checked to see if the file already exists, and if there are
  1102. any duplicates, a list of filenames will be shown to the user and
  1103. the upload process aborted.  These merges are in Bled 2.2 format.
  1104. A batch file is also included to aid in the bled process.
  1105.  
  1106. C-5.    Why is RBatch an external program?
  1107.         ----------------------------------
  1108.  
  1109. The main reason for designing RBatch as an external interface
  1110. instead of relying on internal merges was simple:  not all
  1111. individuals care to recompile RBBS code (only the REAL hard core!),
  1112. and merges for ALL versions of RBBS (12 through 17.4) would have
  1113. had to be written.  Also, PROPER execution of batch uploading inside
  1114. RBBS would require a major rewrite of the code, and considering the
  1115. number of versions out there, this alternative is unacceptable.
  1116. With an external interface like RBatch, everyone can offer batch
  1117. and Bi-Directional transfers now.
  1118.  
  1119.  
  1120. C-6.    Companion Program for RBatch:
  1121.         -----------------------------
  1122.  
  1123. Tom Hansen of Church Chatters BBS has written a companion program for
  1124. use by the users of your BBS to aid them with Batch Uploading, called
  1125. TAG160.ZIP (Check for future updates also, with more features and
  1126. enhancements!)
  1127.  
  1128. This program is designed to simplify the BATCH uploading process for
  1129. your users.  Your users can tag files for uploading and prepare their
  1130. batch uploading sessions in a few simple key strokes.  It supports
  1131. bidirectional protocols and the popular DSZ protocols and allows for
  1132. a user configurable protocol if one of their favorite protocols is not
  1133. an available option.   This program will assist you in training and
  1134. encouraging your users to utilize your BATCH uploading capabilities.
  1135.  
  1136.  
  1137.                                       -21-
  1138.  
  1139. C-7.    Warranty & Disclaimer:
  1140.         ----------------------
  1141.  
  1142. THIS PRODUCT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  1143. INCLUDING ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
  1144. PURPOSE.  THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THE
  1145. PROGRAM IS ASSUMED BY YOU.  FURTHERMORE, I THE AUTHOR DO NOT WARRANT,
  1146. GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE OF OR THE
  1147. RESULTS OF THE USE OF THE PROGRAM, OR THAT THE PROGRAM WILL RUN WITHOUT
  1148. ERROR, AND YOU RELY ON THE PROGRAM AND RESULTS SOLELY AT YOUR OWN RISK.
  1149. I THE AUTHOR CANNOT ACCEPT RESPONSIBILITY FOR SYSTEM DAMAGE, LOSS OF
  1150. PROFIT, OR ANY OTHER SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
  1151. RESULTING FROM THE USE OR INABILITY TO USE THIS PRODUCT.
  1152.  
  1153.  
  1154.  
  1155. As always, with any new program, you should have backup copies of your
  1156. MESSAGES, USERS, FMS or .DIR, and CALLERS files when first installing and
  1157. using RBatch, since it uses these in its operation.
  1158.  
  1159. This program is ZIPPED with Authenticity Verification.  If you do not
  1160. see the registration number of "# MMJ131  THE SHORELINE BBS, there is
  1161. a possibility that it is not an official version or the BBS you
  1162. received it from re-zipped the file and stripped off the -AV.
  1163. You can always call my BBS and download the official version.
  1164.  
  1165.  
  1166. C-8.    Registration:
  1167.         -------------
  1168.  
  1169. This program is being released under the "shareware" concept.  This means
  1170. that you can try it out to see what it is like for a period of time.  If
  1171. after a period of 60 days you continue to use it on your BBS, then regis-
  1172. tration is required.  If you do not wish to register the program, then
  1173. you must discontinue use of the program (the Shareware Police are
  1174. everywhere, so beware!).
  1175.  
  1176. The program is not "Crippled" in any way, and what you get with a
  1177. registered version is your BBS name on the opening screen, and the
  1178. ending screen telling users that it is unregistered, is removed.
  1179. You will also get "Visiting SysOp" access to my BBS which entitles
  1180. you to 60 Minutes/day, and unlimited file downloading.
  1181.  
  1182. I have chosen not to "cripple" the program because I don't believe in
  1183. "crippleware", but with this concept, less people tend to register it.
  1184. I hope that when you use the program you find that it is an excellent
  1185. addition to your BBS, hopefully then registering it.
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.                                       -22-
  1193.  
  1194. Registration lets me know that the program I worked very hard on is
  1195. appreciated.  It will also encourage me to write other useful
  1196. programs/enhancements for RBBS SysOps in the future.
  1197.  
  1198. Once you register RBatch, it is registered for any new version that may
  1199. come out in the future.
  1200.  
  1201.  
  1202. You can get your registered version one of two ways:
  1203. ----------------------------------------------------
  1204.  
  1205. First, for $20.00, mail in the registration form with all the questions
  1206. filled in.  You then call my BBS and get your registration number in a
  1207. private message to you along with a file in the personal files section.
  1208.  
  1209. Second, for $25.00, you can send me the registration form with all the
  1210. questions filled in along with the size of the diskette you wish to
  1211. receive (5 1/4 or 3 1/2).  I will then mail you the latest version of
  1212. the program along with your registration number.
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220. C-9.    Acknowledgments:
  1221.         -----------------
  1222.  
  1223.  
  1224. I would like to thank a few individuals for their support and ideas
  1225. without whom this program would not have been possible.
  1226.  
  1227. First of all, to my wife Linda, my son David, and my daughter Linnea
  1228. for time and again putting up with me parking myself in front of my
  1229. computer for hours on end to work on the program.  (Hey David, we
  1230. probably would have gotten a lot farther in Super Mario Brothers 3
  1231. if I hadn't been working on this program!!! <G>)
  1232.  
  1233. Second, to my Beta Testers--Tom Hansen, Walter Ames, David Brodmann,
  1234. Gregg Snyder, Gary Slemp (for helping out with the tedious task
  1235. of writing this documentation), and Tate Biersack.  Their ideas
  1236. and testing of the program for any sort of bug possible, made it a far
  1237. superior product than it would have ever been.
  1238.  
  1239. Third, to all the people who work on RBBS, and make it the best BBS software
  1240. available.  And last, Borland International Inc., and Data-Comp Information
  1241. Systems, for their great software.
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.                                       -23-
  1248.  
  1249. C-10.   Support:
  1250.         --------
  1251.  
  1252. If you do encounter any problems with the program, or have suggestions
  1253. on improvements, you can call my BBS 24 hrs a day, and leave a message
  1254. for me, or leave a message on the RIME Network in the RBBS conference,
  1255. or in the RBBS-PC or RBBSSYS conference on the RBBS-NET Network (Another
  1256. SysOp friend of mine carries the RBBS-NET and will alert me if there are
  1257. messages for me).  I will consider the enhancements and of course try to
  1258. fix any problems encountered with the program.
  1259.  
  1260. Note that I support both Registered and Non-Registered users of the
  1261. program.  Support is a NUMBER ONE priority for me and my programs,
  1262. and I think you will be impressed with the support that I give.  You
  1263. are welcome to call me voice if you have any problems between 7-10:00pm
  1264. weekdays and between 9am-10pm on the weekends.
  1265.  
  1266.  
  1267.  
  1268. My BBS name & number are:
  1269.  
  1270.  
  1271.  
  1272.  
  1273.                                     Dan Shore
  1274.                                "THE SHORELINE BBS"
  1275.                           Located in Silver Spring, MD
  1276.                                12/24/9600/14.4 HST
  1277.                                   301-946-2771
  1278.                                Proud Member of the
  1279.                          - DGS Systems Group (Wonder) -
  1280.  
  1281.                              RBBS-PC  Beta Test Site
  1282.                              Proudly Running RBBS-PC
  1283.                       "The Best BBS Software in the World"
  1284.  
  1285.                            Member of the RIME Network
  1286.                                Node ID = SHORLINE
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.                                       -24-
  1303.